Obtains the next task ID in the list of available tasks.

OSStatus MPGetNextTaskID (
    MPProcessID owningProcessID, 
    MPTaskID *taskID
);

owningProcessID

The ID of the process (typically the application) that owns the tasks. This ID is the same as the process ID handled by the Code Fragment Manager.

taskID

On return, taskID points to ID of the next task in the list of tasks.

function result

A result code.

DISCUSSION

By iterating on this function, you can obtain the IDs of all the tasks in a given process. These tasks may be running, ready, or blocked. Generally you would only use this function in diagnostic programs.

VERSION NOTES

Introduced with Multiprocessing Services 2.1.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MPLibrary 2.1 or later is installed. Exported by CarbonLib 1.0 and later and by MPLibrary 2.1 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/6/2000)